home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Precision Software Appli…tions Silver Collection 1
/
Precision Software Applications Silver Collection Volume One (PSM) (1993).iso
/
tutor
/
teach241.arj
/
{MANUAL.DOC
< prev
next >
Wrap
Text File
|
1992-11-24
|
86KB
|
2,567 lines
Table of Contents
Chapter 1................................................. 1
1.1 General Description of CAITeach-TW............... 1
1.2 Using this and other Documentation............... 1
1.2.1 Available Documentation................... 1
1.2.2 CAITeach Tutor ........................... 1
1.2.3 Quick Reference........................... 2
1.2.4 Numbering Aid............................. 2
1.2.5 This Manual............................... 2
1.3 Files and Programs with CAITeach................. 2
1.3.1 System of Files........................... 2
1.3.2 Template and Question Files............... 3
1.3.3 Renumbering Utility....................... 3
1.4 Formatting Conventions........................... 3
1.4.1 Keystrokes................................ 3
1.4.2 File Name................................. 3
1.4.3 System Commands........................... 3
1.4.4 Program Names............................. 3
1.4.5 Series Items.............................. 4
1.4.6 Text-Graphics............................. 4
1.5 Operational Glossary............................. 4
Chapter 2 INSTALLING CAITeach............................. 5
2.1 System Requirements with TutorialWriter.......... 5
2.2 System Requirements as a Stand-Alone............. 5
2.3 Significant CAITeach Files....................... 5
2.3.1 File Naming Conventions................... 5
2.3.2 Required Authoring Files.................. 5
2.3.3 CAITeach's Tutorial Files................. 5
2.3.4 Incidental Files.......................... 6
2.3.5 Latest list of files...................... 6
2.3.6 File Reference Conventions................ 6
2.4 General Installation............................. 7
2.4.1 Method 1 - Files in TW Directory.......... 7
2.4.2 Method 2 - Files in Own Directory......... 7
2.4.3 Installation Summary...................... 7
2.5 Running the CAITeach Tutorial.................... 7
2.6 Distributing Completed CAITeach Question Files... 7
2.7 Software License Agreement for CAITeach-TW....... 7
2.7.1 Notice of Copyright....................... 7
2.7.2 License for Registered Version............ 8
2.7.3 License for Other Versions................ 8
2.8 Limited Warranty................................. 8
2.8.1 Registered Version........................ 8
2.8.2 Unregistered Versions..................... 8
2.9 Support and Warranty............................. 8
2.9.1 Registered Program........................ 8
2.9.1.1 Telephone.......................... 8
2.9.1.2 Fax Support........................ 9
2.9.1.3 CompuServe Support................. 9
2.9.1.4 U.S. Postage Service............... 9
2.9.2 General Satisfactory Warranty - Registered 9
2.9.3 Other Versions from Tatam Consulting...... 9
2.9.4 General Warranty - Demo and Share ware.... 9
Chapter 3................................................ 10
3.1 Jargon and Operationally Defined Terms.......... 10
3.2 Overview of CAITeach System..................... 10
3.3 Related Tutorial and Documentation.............. 10
3.4 List of Steps in Creating a CAITeach Test....... 10
3.5.1 Step 2................................... 11
3.5.2 Run CAITest from TutorialWriter.......... 11
Chapter 4................................................ 12
4.1 Definition of Merging........................... 12
4.2 Ways to Merge Files............................. 12
4.1 Pasting between ........................... 12
4.2 Pasting.................................... 12
4.3 DOS Merging................................ 12
4.3 Merging a Template Into the TW Editor........... 14
4.4 Comment on Editors.............................. 15
Chapter 5................................................ 16
5.1 Definition of CAI Template...................... 16
5.1.1 Number of Lines, Width and Margin........ 16
5.1.2 Sequence and Processing of Data on Lines. 16
5.1.3 Generic Template......................... 16
5.2 Conceptual and literal Parts of all Templates... 17
5.3.1 Conceptual Organization Summary.......... 17
5.3.2 Identical Lines ......................... 17
5.5.2.1 The Number Line................... 18
5.5.2.1.1 Functions.................. 18
5.5.2.2.1 Three Parts ............... 18
5.5.2.2 The Remarks Line.................. 19
5.4.4.3 The Ruler Line.................... 19
5.5 Percents and Tildes............................. 19
5.5.1 Part of Fill-In Question Answer.......... 19
5.5.2 Display of Percent Sign.................. 19
5.5.3 Display of Tildes........................ 19
5.5.4 Tutorial on Percents and Tildes.......... 20
5.6 Screen Display.................................. 20
5.6.1 General.................................. 20
5.6.2 Question Count........................... 20
Chapter 6................................................ 21
6.1 Completing a template........................... 21
6.2 Other References................................ 21
6.3 Definition of CAITemplate - Review of Chapter 5. 21
6.3.1 Lines, width and screen margin........... 21
6.3.2 Sequence of Data on Lines................ 21
6.3.3 Number, Remarks, and Ruler............... 21
6.4 General Identity of CAITemplates................ 21
6.5 Question Code and the Citation Line............. 21
6.5.1 Question Code Line....................... 22
6.5.2 The Citation Line........................ 22
6.6 The Study Template.............................. 22
6.6.1 Header Lines............................. 22
6.6.2 Text Lines............................... 23
6.6.3 Graphic Figure........................... 23
6.6.4 Answer Lines............................. 23
6.7 The Fill-In Template............................ 23
6.7.1 Header Lines............................. 23
6.7.2 Text Lines............................... 23
6.7.3 Graphic Figure........................... 24
6.7.4 Answer Line.............................. 24
6.7.5 The Answer Note Line..................... 24
6.8 The True-False Template......................... 24
6.8.1 Header Lines............................. 24
6.8.2 Text Lines............................... 25
6.8.3 Mouse Hot Spots.......................... 25
6.8.4 Graphic Figure........................... 25
6.8.5 Answer Line.............................. 25
6.8.6 The Answer Note Line..................... 25
6.9 The Multiple Choice Template.................... 25
6.9.1 Header Lines............................. 26
6.9.2 Text Lines............................... 26
6.9.3 Mouse Hot Spots.......................... 26
6.9.4 Answers Items............................ 26
6.9.5 Correct Answer........................... 26
6.9.6 The Answer Note Line..................... 26
Chapter 7................................................ 27
7.1 Preparation for Running from TutorialWriter..... 27
7.2 Other Considerations............................ 27
7.3 Running CAITeach Test from TutorialWriter....... 28
7.3.1 The Pound U, or ......................... 28
7.3.2 The Driver, ............................. 28
7.3.3 The Test File............................ 28
7.3.4 The Title................................ 28
7.3 Running CAITeach Test from DOS.................. 28
7.4 The Printout.................................... 29
CHAPTER 8 Quick Reference................................ 29
8.1 A version of Quick Reference follows............ 29
8.2 Template and File Types......................... 29
8.3 Testing at DOS and from TW...................... 29
8.4 Characteristics of ALL Templates................ 29
8.5 Conceptual Divisions of CAITeach Templates...... 29
8.6 Generic Template Summary........................ 31
8.7 Summary of Steps to Prepare CAITest............. 32
CHAPTER 9 Renumbering Aid................................ 33
CHAPTER 10 Operational Definitions....................... 34
Chapter 1 INTRODUCTION
This chapter describes CAITeach-TW, (CAIT), lists and briefly
discusses the documentation, and specifies conventions.
1.1 General Description of CAITeach-TW
CAITeach is an electronic tester that works with
TutorialWriter (TW). One constructs a CAITest by merging and
composing information and question screens. The CAITest is tested
at the system prompt and run from TW. When tested at DOS or run
from TW, CAITest displays, scores, and optionally prints a student
report. A mouse is recommended.
A suitable text editor comes with TW, or one could use any
text editor, or a word processor which merges and saves ASCII
files.
CAITeach displays one template per standard (80x25) screen.
It comes with three question, and one text screen template:
True-False Multiple Choice fill-in
(Completion) Study (text)
Each is detailed later.
The CAITeach authoring files consist of a driver, four
template files, and a renumbering utility, all start with a left
brace ({). That left brace aids with file management, and avoids
overwriting TW, and other files.
1.2 Using this and other Documentation
1.2.1 Available Documentation
Documentation for CAITeach consists of a:
CAITeach Tutor...... called CAITeach Tutor/disk tutor
Quick Reference .... called Quick Reference
Runumbering Aid .... called NumAid or Numbering Aid
Reference Manual ... called CAITeach Reference Manual,
or CAITeach Manual
The last three are available by printing a text file.
Quick Reference........{QIKREF.DOC
Numbering Aid..........{NUMAID.DOC
Manual.................{MANUAL.DOC
1.2.2 CAITeach Tutor (Disk)
The CAITeach tutor is written in TutorialWriter and is
the main source for learning CAITeach. It starts with the command
TWTEACH TWCAI.
CAITeach MANUAL, Introduction, Chapter 1 -------------------- Page 1
1.2.3 Quick Reference
Quick Reference is a two page summary that summarizes the
CAITeach Program and is printed from {QIKREF.DOC, either with an
editor, or with the DOS type command:
TYPE {QIKREF.DOC> PRN
Quick Reference is an immediate reference. Many users will,
after scanning the tutorial, and with the Quick Reference and
NumAid printout, be writing in an hour.
1.2.4 Numbering Aid
The Numbering Aid is a single page table that lists the
Question Line Number (Line 1) for 40 questions. If printed in
condensed type it fits on the top of most keyboards. I always have
one beside my keyboard. For example, when I'm working on question
35 a quick glance tells me that question 35 starts on line 561, and
ends on line 577.
1.2.5 This Manual
It is not necessary to read the manual, although a
printed copy may be helpful, depending on how you write. It is
intended for reference. We learn differently but most will prefer
the interactive disk tutorial.
This is an inclusive reference manual, formatted for
printing or disk reference. It repeats information found in the
disk tutor, and provides some additional theory and details.
1.3 Files and Programs with CAITeach
1.3.1 System of Files
CAITeach is a system of files. The system is called
CAITeach. All significant files, except tutor and incidental
files, start with a left brace. A file is sometimes referenced by
its general name, or function, or by its disk name. The following
table clarifies this convention.
- General Name - - Disk Name -
CAITeach-TW {TEACHTW.EXE
CAITeach {TEACHTW.EXE
CAIRenumber {RENUM
Renumbering Utility {RENUM
CAITeach MANUAL, Introduction, Chapter 1 -------------------- Page 2
A template file may be either a text (study) or question
file. These are detailed in this documentation, and in the
CAITeach Tutorial. Each file formats a particular question or
screen.
- Formats - - Disk File -
Text/Study Screen {T-STUDY.CHP
True-False Question {T-TF.CHP
Fill-In (Completion) Question {T-KB.CHP
Multiple Choice Question {T-MC4.CHP
1.3.2 Template and Question Files
One composes a CAITeach test by merging and editing
disk files, called "templates." One template file is a text
formatter, {T-STUDY.CHP file; however, it is sometimes, for
brevity, referenced a "question" file.
1.3.3 Renumbering Utility
The numbering utility is the {RENUM.EXE program. It is
referenced as the Renumbering Utility, CAIRenumbering Utility, or
CAIRenum.
1.4 Formatting Conventions
1.4.1 Keystrokes
Key strokes are capitalized, and enclosed in brackets.
Example: [ENTER] is the key stroke for pressing the enter, or
return key. Second example: [Control KR], and [^KR] is the
keystroke for holding down the control key and pressing the K and R
key.
1.4.2 File Name
File names are capitalized, and may include wildcards.
Example: all the CAITeach tutorial files are in TWCAI?.CHP.
1.4.3 System Commands
System commands are capitalized. For example: DIR {*.CHP.
1.4.4 Program Names
Programs such as Quick Edit, MultiEdit, TutorialWriter, and
discrete elements of CAITeach are treated as proper nouns.
CAITeach MANUAL, Introduction, Chapter 1 -------------------- Page 3
1.4.5 Series Items
Series items may be formatted with the comma outside the
quotation marks, an acceptable convention for technical writing.
An example is: 'The answer must be an "A", "B", or "C".' The effort
is to avoid the repetitious "don't use quotes."
1.4.6 Text-Graphics
Not all printers print text-graphics. All graphics
are illustrated with common characters, such as colons and dashes
rather than the extended characters. Therefore, the text-graphic
figures do match the template files.
1.5 Operational Glossary
A limited glossary is at the end of this manual.
CAITeach MANUAL, Introduction, Chapter 1 -------------------- Page 4
Chapter 2 INSTALLING CAITeach
This chapter outlines the hardware and software requirements for
CAITeach-TW, (CAIT).
2.1 System Requirements with TutorialWriter
These are the same as for TutorialWriter, except the printer.
* An IBM or compatible Personal Computer.
* CH., EGA, or VGA display.
* IBM or MS Operating System, 3.0 or higher.
* 300 K of memory
* generic printer for student data sheet
CAIT requires a generic printer for the optional printed
student or personnel report. The report is formatted for pica, (10
characters per inch), but looks acceptable with elite (12
characters per inch). No special characters are used in format.
2.2 System Requirements as a Stand-Alone
Same requirements denoted in Paragraph 2.1, except CAIT runs
on 256K. It can be tested on a monochrome monitor.
2.3 Significant CAITeach Files
2.3.1 File Naming Conventions
Note that all significant CAIT files start with a
left brace, "{", which aids copying and sorting. For example, the
command DIR {*.* displays a list of all significant files.
2.3.2 Required Authoring Files
Minimum files required to compose a CAITeach test.
{TEACHTW.EXE - driver file.
{T-STUDY.CHP - template for Study Screen
{T-TF.CHP - template for True-False Question
{T-KB.CHP - template for Fill-In Question
{T-MC4.CHP - template for Multiple Choice Question
{RENUM.EXE - Renumbering Utility (optional)
All other files are support files. You may remove
them from your hard disk.
2.3.3 CAITeach's Tutorial Files
A detailed tutorial, written in TutorialWriter is a
primary tool for learning CAIT. Its configuration file,
CAITeach MANUAL, System Requirements, Chapter 2 -------------- Page 5
TWCAI.CNF and the related chapter files (TWCAI?.CHP), help, and
hypterext files must be in the same directory as the TutorialWriter
driver, TWTEACH. Additionally this tutorial is supported by
{4TYPES.CHP, {4TYPES.COM, {DEMO.CHP, and {PERTIL.CHP. {4TYPES.COM
is {4TYPES.CHP converted to a command file, color and notes added.
TutorialWriter will not accept a left brace as part of
the menu name. All CAITeach tutorial files start with TWCAI.
2.3.4 Incidental Files
The CAITeach disk may include incidental files, such as
README.
2.3.5 Latest list of files
The file, {FILES.DOC, contains an annotated list of all
CAITeach files.
2.3.6 File Reference Conventions
CAITeach is a system of files. As a system it is
referenced "CAITeach" or "CAIT." However, all authoring files
start with a left brace, "{", which denotes a particular file
within the system. A file is sometimes referenced by its general
name, or function and by its name-on-the disk. The following table
further clarifies this convention.
- General Name - - Executable File -
------------ ---------
CAITeach-TW {TEACHTW.EXE
CAITeach {TEACHTW.EXE
CAIT Driver {TEACHTW.EXE
CAIRenumber {RENUM
Renumbering Utility {RENUM
CAIT Tutorial TWTEACH TWCAI
CAITeach Tutorial TWTEACH TWCAI
CAI Disk Tutor TWTEACH TWCAI
A template file may be either a text (study) or question
file. These are detailed later, and in the CAITeach Tutorial.
See Chapter 1 for other conventions.
CAITeach MANUAL, System Requirements, Chapter 2 -------------- Page 6
2.4 General Installation
The CAITeach distribution disk has two files. One is a
self-extracting archive of all CAITeach files, except for INSTALL.
Instructions, which vary with different versions are included on
the disk. There are two general ways.
2.4.1 Method 1 - Files in TW Directory
Simply copy the contents of disk to your TW directory
and enter the name of the archived file. Note that all these files
start with a left brace, or TWCAI. This is the default installation.
2.4.2 Method 2 - Files in Own Directory
The CAITeach files may be installed in a separate
directory, and CAITests developed in that directory, and the new
file tested at the system (DOS) level. However, the driver,
{TEACHTW and your newly created files must be in the same directory
as TWTEACH when called from TutorialWriter. See the TW
documentation on execution of programs with the #U command.
2.4.3 Installation Summary
You may develop and DOS test CAITeach files independently
of TutorialWriter.
However, when CAITeach files are called from
TutorialWriter with the #U command both {TEACHTW.EXE and the
question files (CAITeach Test File) must be in the directory with
TutorialWriter, or its driver TWTEACH.
The installation program may suggest either.
2.5 Running the CAITeach Tutorial
The CAITeach tutorial is started as any other TW
tutorial. The command is TWTEACH TWCAI.
CAITeach tutorial files do not start with the left brace, but
do start with start with TWCAI. Example: the configuration file is
TWCAI; Chapter one is TWCAI1.CHP; the help file is TWCAI.HLP.
2.6 Distributing Completed CAITeach Question Files
The driver, {TEACHTW and your CAITest files should be distributed
in the same directory as your TutorialWriter files. You may
rename {TEACHTW.
2.7 Software License Agreement for CAITeach-TW
2.7.1 Notice of Copyright
CAITeach is copyrighted by Tatam, Consulting, 332 Warwick
Way, Lawton, OK 73501.
CAITeach MANUAL, System Requirements, Chapter 2 -------------- Page 7
2.7.2 License for Registered Version
The registered version of CAITeachTW - System is licensed
for installation on a single computer at any one time. The
CAITeachTW-System includes all files except the driver, {TEACHTW.
Registered users may distribute the driver, {TEACHTW without
restriction.
2.7.3 License for Other Versions
The share ware and demonstration disk are for your personal
evaluation and study. Make any copies, and you freely give them to
anyone for evaluation.
Use of share ware CAITeach, in a business, school,
profit, or nonprofit organization is unauthorized, except for
evaluation on a single machine.
There is a nagging screen which displays after each run
of {TEACHTW, and a copyright notice is printed on all data sheets.
2.8 Limited Warranty
2.8.1 Registered Version
Only the disk is warranted and will be replaced within 60
days without charge. After 60 days there is a small handling and
duplication fee for registered users, presently $4 plus postage.
No warranty is extended as to suitability of task,
machine compatibility, or for loss of any profit, including time,
beyond the original cost of the software.
2.8.2 Unregistered Versions
If purchased directly from Tatam Consulting only the disk
is warranted and will be replaced within 10 days without charge. No
warranty is extended as to suitability of task, machine
compatibility, or other loss, including time, profit or gross
income beyond the original cost of the software.
2.9 Support and Warranty
2.9.1 Registered Program
2.9.1.1 Telephone Support - 1(405)357-6571
CAITeach MANUAL, System Requirements, Chapter 2 -------------- Page 8
The following table outlines my telephone support
hours, classified by the chance of my being immediately available.
Telephone Support Hours
.------------------+---------------------------------.
: Probability : Hours :
: -----------------:---------------------------------:
: 99% of time : 8:00 A.M. - 12:00 A.M, daily :
: 25% of time : 1:00 P.M. - 5:00 P.M, daily :
: 50% of time : 7:00 P.M. - 9:00 P.M, daily :
: 75% of time : 8:00 A.M. - 12:00 A.M, Sat :
: 75% of time : 8:00 A.M. - 9:00 P.M, Sun :
+------------------+---------------------------------+
I reserve the right to not return calls.
2.9.1.2 Fax Support
Fax support is available at the same number, and is
either received by computer or switched to an external fax. When
manually faxing you may receive a recorded voice message advising
you to press the "send" button but the system works automatically,
and will confirm receipt of your fax.
2.9.1.3 CompuServe Support
CompuServe support is available. Send your mail to
Bill Tatam, Compuserve ID is 71242,2026.
2.9.1.4 U.S. Postage Service
Correspondence, preferably on a disk in an ASCII
file showing an example of the problem, or asking a question will
be answerer. If you enclose $2.50 we will send it two-day mail.
2.9.2 General Satisfactory Warranty - Registered
The product may be returned within 10 days for a
complete refund, except for the original shipping, handling, and
postage charges.
2.9.3 Other Versions from Tatam Consulting
There is a half hour limit on telephone support.
Telephone calls will not be returned unless you authorize collect
calls.
2.9.4 General Warranty - Demo and Share ware
If you purchased the program directly from Tatam
Consulting it can be returned within 10 days for a complete refund,
except for the original shipping, handling, and postage charges.
CAITeach MANUAL, System Requirements, Chapter 2 -------------- Page 9
Chapter 3 BEGINNING CONCEPTS
3.1 Jargon and Operationally Defined Terms
This chapter is a summary of CAITeach. Summaries
condense material, else they would not be summaries. Words,
procedures, and terms referenced in this section are expanded
within the manual. You may wish to scan the brief glossary.
3.2 Overview of CAITeach System
CAITeach is an add-in for TutorialWriter. The sole
purpose of CAITeach is to help develop, administer, and obtain a
printed score sheet from a computer administered objective test.
A CAITest is written in a text editor, or a word processor in
the ASCII or text mode. Such tests are created by merging CAI
templates into a working file in an editor, called a CAITest file.
Once merged the templates are edited, a question or text screen
written and the file saved. The accepted extension is CHP,
primarily because the TW editor prefers this extension on startup.
A CAITest file is tested at the system prompt by first
checking it with a renumbering utility (optional), and then testing
it with CAITeach, a driver file, specifically {TEACHTW. Next the
CAITest it is run from TutorialWriter, one screen at a time, using
TutorialWriter's #U command.
When run with {TEACHTW, {TEACHTW displays each screen and
prompts for an answer. The screen is updated for score, question
count, and text-graphic after each question. When finished
displaying the CAITest file the user is prompted for a printed
score and record sheet. After CAITeach insures there is a printer
it prints the report and returns to TutorialWriter.
3.3 Related Tutorial and Documentation
This entire process is detailed in the CAITeach disk tutorial
that is started by entering TWTEACH TWCAI. Additionally this
documentation is supplemented by Quick Reference, a two page
printout contained in the text file {QIKREF.DOC; and the one page
printout, NumAid, contained in the text file {NUMAID.DOC. A
version of these is at the end of this manual.
3.4 List of Steps in Creating a CAITeach Test
The procedural steps are:
1. Compose tutorial in TutorialWriter
2. Construct CAITest
3. Call CAITest from inside TutorialWriter
Step 1 is discussed in the TutorialWriter documentation.
These steps assume that one knows the subject, and can write in
this medium.
CAITeach MANUAL, Beginning Concepts, Chapter 3 -------------- Page 10
3.5.1 Step 2
As discussed in the disk tutor there are four parts, or
substeps to Step 2. They are:
1. Merge templates into editor
2. Edit templates (Renumber is optional)
3. Write questions or text screens
4. Save and test at system prompt (DOS)
These are detailed in the next chapters.
3.5.2 Run CAITest from TutorialWriter
A CAITest is run from TutorialWriter with the #U, as
detailed in a later chapter.
CAITeach MANUAL, Beginning Concepts, Chapter 3 -------------- Page 11
Chapter 4 MERGING WITH THE TW EDITOR
This chapter discussing merging, and details the merging procedure
with the TutorialWriter editor.
4.1 Definition of Merging
Merging is the process of combining two similar files.
4.2 Ways to Merge Files
There are at least three ways to construct a CAITest file, each
broadly defined as merging. The usual way is in merging directly
from DOS, the third way described.
4.1 Pasting between "Windows" of an Editor/Word Processor
With an editor such as Quick Edit (QEDIT), MultiEdit, or
within Microsoft's Windows it is possible to load each of the
templates into a "window" and paste the desired template into a
master file. Depending on one's style this may work well.
4.2 Pasting
Not all editors will merge a file. Microsoft's 5.0 DOS
editor will not. However, it is possible to use the DOS COPY
command to combine all four templates into a single file. To
combine the templates, enter at the system prompt:
COPY {T-STUDY.CHP + {T-TF.CHP + {T-MC4.CHP + {T-KB.CHP {ALL.CHP
After this, load {ALL.CHP into the an editor or word
processor. One now has all the templates in the editor. Select
(block) and copy each template (set of 16 lines)to its new
position in the file as needed.
When finished, renumber (optionally), delete the blank
templates. You'll have to decide if you like this or not. You may
be able to patch or create new extended characters (ASCII 219, etc)
with the [ALT-KEYPAD-NUMBER] sequence in some editors, just as in
the TW editor. This depends on your editor and your style.
4.3 DOS Merging
The classical way to merge a file is to incorporate
it into a file directly from DOS. An editor usually has an option
under FILE, which may be called:
Merge Read Read Block
Insert Import Text In
Or, the function may be assigned to a function key, or a
key stroke. The most common keystroke for this is [Control K R],
which is also written "^KR"---no quotes. This key stroke is used
by the TutorialWriter editor.
CAITeach MANUAL, Merging with the TW Editor, Chapter 4 ------ Page 12
CAITeach MANUAL, Merging with the TW Editor, Chapter 4 ------ Page 13
4.3 Merging a Template Into the TW Editor
This subsection outlines the procedure for merging
template files into the TW Editor.
1. Create a new file in the editor. This is the
same option as "2. Create/Edit Chapter." When prompted for a file
name enter the desired file name, and a new file is created. The
extension must be CHP.
2. Once in the editor hold down the Control and
press the K and R keys at the same time.
3. Observe the prompt at the top of the screen,
which reads as abstracted in the next figure.
Merging Prompt
+-----------------------------------------------------+
: F1-Help * * TutorialWriter * * :
: Read block from file: C:\CAITEACH\{T-TF.CHP :
+-----------------------------------------------------+
Figure 4.1 Merging Prompt, completed, in TW Editor
4. Enter, as in the figure above, the name, and path
of the template file that you wish to merge. In this example I am
merging the true-false template, located in my CAITEACH directory.
5. After pressing [ENTER] observe that the line on
which the cursor is located is numbered, upper left after "Line."
Although you can't see the cursor, it was on line 4 when I
abstracted the next table?
Line Counter
.----------------------------------------------.
: F1-Help * * TutorialWriter * :
: Line 4 Col 1 Insert D: :
:1 = Q 1 = 17 :
:; :
:TF :
+----------------------------------------------+
Figure 4.2 Line Counter in TW Editor
6. When ready for the next template position the cursor
and press [Control KR].
7. Should you delete part of CAITeach's text-graphic
consult the editor's ASCII chart.
8. While editing it is easy to delete a line. Observe
the line indicator in the upper corner. You may need a printout of
the Numbering Utility ({NUMAID.DOC).
CAITeach MANUAL, Merging with the TW Editor, Chapter 4 ------ Page 14
9. After constructing the test and checking the line
sequence, save it. You can check it immediately at DOS
with {RENUM, which starts the renumbering utility. When prompted
enter the name and extension. If it fails see the note below on
the END-OF-FILE error help screen.
Your next step is to test at DOS, described in detail
later, but summarized here. Assume you have just created TEST.CHP,
and it passed the {RENUM check. To test it at DOS enter:
{TEACHTW TEST.CHP [Title Optional]
You may wish to reedit. To reedit it, simply load
it into the editor, make your changes and test it again at DOS.
Note. Read the END-OF-FILE option when you run Renumber
the first time, or especially when it shows an error in the last
question. It is possible to create invisible lines in the TW
editor. Invisible lines are lines that exist after what appears to
be the end of the file. You can not see the lines, but {TEACHTW
finds, reads them, and generates an error. Such lines may be
created by pressing [ENTER] or by deleting lines at the end of the
file. To delete imagine they are there, delete several after your
last line and test with [DownArrow]. If pressing [DownArrow] lets
you go more than one line beyond your last line you have invisible
lines.
4.4 Comment on Editors
CAITeach's text-graphics are the figures included in the
in the template files, such as the Library Sign in the Study
template.
Not all editors will display text-graphics. Some display
but will not print. Because of this we have modified them for this
file, formatted for printing.
Remember. These text-graphics are optional. Change them,
or edit them in the TutorialWriter Editor.
If running Windows or MS-DOS 5 you might try keeping an
editor, and two copies of TutorialWriter (one for running, one for
utilities) in memory at the same time, and task switching. With
Windows and a 386 you can even copy and paste between editors and
the Tutorial Writer utilities, such as the Help and Hypertext
screens. Watch for a share violation.
CAITeach MANUAL, Merging with the TW Editor, Chapter 4 ------ Page 15
Chapter 5 TEMPLATE ORGANIZATION - SCREEN DISPLAY
This chapter discusses the common elements of all CAI
Templates. Later chapters briefly mention these common elements,
but detail the differences, and refer to this chapter for the
common elements. This chapter also disscusses tildes and percents,
and the screen display header.
5.1 Definition of CAI Template
5.1.1 Number of Lines, Width and Margin
A CAI template file is an arrangement of 16 lines, 75
characters wide. When run by the driver, {TEACHTW, the left screen
margin is set at 3. These, and the color are fixed.
5.1.2 Sequence and Processing of Data on Lines
The CAITeach driver, {TEACHTW, expects to find certain
data in the CAITest file. The data and its sequence are critical.
5.1.3 Generic Template
Although the templates vary, certain elements are common,
such as the number of lines, and the remark line. We will start
our study of the templates by examining their common parts.
Here is a generic template, right margin cut, commented.
Generic Template
.----------------------------+-------------+------------.
: Edited : Line : Concept :
: Template : Number : Id :
:----------------------------:-------------:------------:
: Question Number Line : 1 : Header :
: ; : 2 : Header :
: Question Code : 3 : Header :
: Citation or Comment line. : 4 : Header :
: Rule:r...1....:....2....:> : 5 : Header :
: : 6 : Text :
: :::::::::::::: : 7 : Text :
: Graphic : 8 : Text :
: optional : 9 : Text :
: on True-False, : 10 : Text :
: Fill-In, and : 11 : Text :
: Study : 12 : Text :
: :::::::::::::: : 13 : Text :
: : 14 : Text :
: Varies : 15 : Answer :
: Varies : 16 : Answer :
+-------------------------------------------------------+
Figure 5.1 Template: Lines and Concept
CAITeach MANUAL, Template Organization, Chapter 5 ----------- Page 16
Note that in the Generic Template, previous page, the Text
lines consist of mouse, and formatted blank lines according to the
particular template. The Ruler, an editing tool extends to Column
75, as do the other lines.
5.2 Conceptual and literal Parts of all Templates
5.3.1 Conceptual Organization Summary
All templates may be divided into three parts:
Header .............. 5 lines
Text ............. 9 lines
Answer ............. 2 lines
=============
Total 16
All templates have 16 lines. These are summarized, and
detailed in Quick Reference, and next.
5.3.2 Identical Lines (elements) Identity
Each line, or element, in a template also has a name.
Individual lines belong to a conceptual group. The conceptual
group (header, text, answer) was identified above. Next, each line
is identified as an element, with a name and its position in the
sequence.
Generic Template
.-------------------------------------------------------------.
: Edited Template : Line : Concept :
: * edited : Number : Id :
:----------------------------:-------------:------------------:
: Number = Q Number = Number : 1 : Answer Line :
: ; : 2 : Comment Line :
: STUDY/TF/KB/MC4 : 3 : Question Code :
: Citation or Comment line. : 4 : Citation Line :
: Rule:r...1....:....2....:> : 5 : Ruler Line :
: : 6 : Text 1 :
: ::::::::::::::: : 7 : Text 2 :
: Graphic : 8 : Text 3 :
: optional : 9 : Text 4 :
: on True-False, : 10 : Text 5 :
: Fill-In, and : 11 : Text 6 :
: Study : 12 : Text 7 :
: ::::::::::::::: : 13 : Text 8 :
: : 14 : Text 9 :
: Answer : 15 : Answer Line :
: Answer : 16 : Answer Note :
+-------------------------------------------------------------+
Figure 5.2 Template: Lines and Literal ID
Identical Elements in each Template
CAITeach MANUAL, Template Organization, Chapter 5 ----------- Page 17
Although there are similarities between all template lines,
there are three exact lines:
Question Number Line ........... Line 1
Remarks Line ................... Line 2
Ruler Line ..................... Line 5.
5.5.2.1 The Number Line
5.5.2.1.1 Functions
It serves as an editing aid. No part of the
CAITeach system uses anything but the first number, identified
next, except as a filler in the sequence of 16 lines. The number
of questions is calculated by the number of lines in the program,
not read from the CAITest file.
The Question Number line is used
diagnostically by the CAIUtilities, such as the renumber utility.
The renumbering utility works if it finds a number of than 0 on
this line.
5.5.2.2.1 Three Parts (N1= Q N2 = N3)
The first line of every template is the
Question Number Line, and it optionally consists of three parts,
the second two separated by an equals sign.
Part 1 Part 2 Part 3
+--------------------------------------------------------+
:Variable : Number1 : = Q Number2 : = Number3 :
:Example : 241 : = Q 16 : = 257 :
+--------------------------------------------------------+
1. Part 1 - Number1
The first number must in the first five spaces. It is the
line number of that line in the CAITeach Test File. CAITeach works
with any number here, but {RENUM looks for an exact number.
CAIUtilities will process any number up to 99999.
2. Part 2 - = Number2
The second number is preceded by an equals and Q. Both are
cosmetic, but written by the numbering utility. The number is the
question number starting on that particular line. It is only an
editing aid.
3. Part 3 - = Number3
Part three is preceded by an equals sign. It is also placed
there by the renumbering utility, and is exclusively an editing
aid.
CAITeach MANUAL, Template Organization, Chapter 5 ----------- Page 18
5.5.2.2 The Remarks Line
The second line is always the remarks line, and it
must start with a semicolon. One could use the remainder of the
line for any comment or note. The program uses it as a filler, but
advanced diagnostics check the first semicolon.
5.4.4.3 The Ruler Line
The fifth line is always the ruler line. It is
an editing aid, and you may delete all but the first five
characters if you wish. An advanced diagnostic checks it (not
CAITeach-TW). It merely sets the right margin at 75, but remember
the left screen margin is 3. Therefore, the 75 on the ruler is
column 78 on the screen.
5.5 Percents and Tildes
Almost every compiler has difficulty managing certain symbols
which are reserved for compiler use. There are complications in
using both the percent and tilde symbols.
5.5.1 Part of Fill-In Question Answer
The program will not process a tilde, or percent sign as
part of an answer to a Fill-In question. You may use either
character in the text lines, i.e, you can ask a question using
either character, but these characters can not be part of the
answer in the fill-in question. There are no problems in using
either symbol with other question types.
5.5.2 Display of Percent Sign
To display a percent sign preface it with a tilde. For
example, the line "It is 10~%off" displays "It is 10 % off"---note
there is no space after the "0." The CAIUtilities will process
this line.
5.5.3 Display of Tildes
Tildes must be prefaced with three other tildes, for a
total of four. For example. the line "This is a tilde (~~~~)."
displays "This is a tilde(~)." However, the CAIUtilities will not
process a tilde.
To display a tilde substitute another character, such as
the grave character (accent), "`" ---- finish all runs with the
utilities, and as a last step replace the four graves with four
tildes.
CAITeach MANUAL, Template Organization, Chapter 5 ----------- Page 19
5.5.4 Tutorial on Percents and Tildes
There is a tutorial, written in CAITeach that outlines use of
the tilde and percent sign. To run it enter {TEACHTW {PERTIL.CHP.
5.6 Screen Display
5.6.1 General
CAITeach uses a complete screen for each question or study
template. The screen messages mean exactly what they say. If a
compatible mouse is installed it is shown on the first display.
5.6.2 Question Count
The question count and score exclude the study screens.
CAITeach MANUAL, Template Organization, Chapter 5 ----------- Page 20
Chapter 6 TEMPLATES
Chapter 5 introduced templates. This chapter discusses the
specific templates, including the question codes, the mouse button
locations, the text lines, the filler text lines, and the answer
lines.
6.1 Completing a template
It is necessary to know where to write within the template,
and how to check a template in an editor before saving. Since it
is easy to delete comments the templates merge with a suggested
format. Of course, there's no reason you can't edit these out of
the master, or add your own.
6.2 Other References
These templates are displayed, by entering {TEACHTW NAME.EXT,
as in the example: {TEACHTW {T-TF.CHP, which displays the
true-false template.
6.3 Definition of CAITemplate - Review of Chapter 5
6.3.1 Lines, width and screen margin
A CAITemplate file is a sequence of 16 lines, 75
characters wide.
6.3.2 Sequence of Data on Lines
The computer program, {TEACHTW, expects certain data when
it process the CAITest. The data and its sequence are critical.
6.3.3 Number, Remarks, and Ruler
These were discussed in Chapter 5.
6.4 General Identity of CAITemplates
There are four CAITemplates, each contained in a file:
Study Template............... {T-STUDY.CHP
True-False Template.......... {T-TF.CHP
Fill-In Template............. {T-KB.CHP
Multiple Choice.............. {T-MC4.CHP
A CAITest is constructed by merging one or more into a file,
called a CAITest and eventually run by TW.
6.5 Question Code and the Citation Line
Two lines, the question code and the citation are so
similar in all templates that they are discussed next. Please
refer to the Quick Reference, or to Figure 6.1
CAITeach MANUAL, Specific Templates, Chapter 6 -------------- Page 21
6.5.1 Question Code Line
Line 3 must contain a question code, as suggested by
the name of the file. These are merged with the file, and are:
Study Template ............. STUDY
True-False Question......... TF
Fill-In Question ........... KB
Multiple Choice............. MC4
The KB abbreviates keyboard -- others are mouse input.
The "4" in multiple choice refers to 4 choices.
6.5.2 The Citation Line
Line 4 is used as a citation for one's question, or for
any other information which one wishes to display with the
question. If left blank a blank line displays.
6.6 The Study Template (QCode STUDY)
The next figure shows an edited Study Template.
Study Template
+-------------------------------------------------------+---+
:1 = Q 1 = 17 : 1 :
:; : 2 :
:STUDY : 3 :
:Citation or Comment line. : 4 :
:Rule:r...1....:....2....:....3....:....4....:....5....:: 5 :
: : 6 :
:************** : 7 :
:************** : 8 :
:** Library ** : 9 :
:** OPEN! ** :10 :
:************** :11 :
:************** :12 :
:************** :13 :
: :14 :
:; :15 :
:; :16 :
+-------------------------------------------------------+---+
Figure 6.1 Study Template, edited, with line numbers
Note: Ruler line is 75 characters wide.
6.6.1 Header Lines
The first five lines, the header lines were
previously detailed, and are summarized in Quick Reference.
CAITeach MANUAL, Specific Templates, Chapter 6 -------------- Page 22
6.6.2 Text Lines
The question is written anywhere on the text lines, lines
6 through 14. You may start on any line. Lines left blank are
displayed blank.
6.6.3 Graphic Figure
The text-graphic is optional. Delete or substitute.
6.6.4 Answer Lines
Although termed the Answer Lines the last two lines
in a Study Template start with a semicolon, and contain nothing
else if your program is to remain compatible with other versions of
CAITeach.
6.7 The Fill-In Template (QCode KB)
The next figure shows an edited Fill-In Template.
Fill-In Template
+-------------------------------------------------------+---+
:1 = Q 1 = 17 : 1 :
:; : 2 :
:KB : 3 :
:Citation line : 4 :
:Rule:r...1....:....2....:....3....:....4....:....5....:: 5 :
: : 6 :
: *********** : 7 :
: * * : 8 :
: * * : 9 :
: *********** :10 :
:************* :11 :
:*:::::::::::* :12 :
:************* :13 :
: :14 :
:ANSWER HERE :15 :
:None :16 :
+-------------------------------------------------------+---+
Figure 6.2 Fill-In Template, edited, with line numbers
Note: Ruler line is 75 characters wide.
6.7.1 Header Lines
The first five lines, the header lines were previously
detailed, and are summarized in Quick Reference.
6.7.2 Text Lines
The question is written on the text lines, lines 6
through 14. You may start on any line. Lines left blank are
displayed blank.
CAITeach MANUAL, Specific Templates, Chapter 6 -------------- Page 23
6.7.3 Graphic Figure
The text-graphic is optional. Delete, or substitute.
6.7.4 Answer Line
Line 15 is the answer line. It holds the answer to the
question, case immaterial. All letters are converted to upper
case, and displayed after the student, either correctly or
incorrectly, answers the question. It could be 65 characters.
6.7.5 The Answer Note Line
Line 16 contains "None" (no quotes) or a note. The
word "None" suppresses display of the line, but any other comment
is displayed after the word "Note:", exactly as enclosed in
brackets: [Note: ]. It displays a comment after the student,
correctly or incorrectly, answers the question.
6.8 The True-False Template
The next figure shows an edited True-False Template.
True-False Template
+-------------------------------------------------------+---+
:1 = Q 1 = 17 : 1 :
:; : 2 :
:TF : 3 :
:Citation or Comment line. : 4 :
:Rule:r...1....:....2....:....3....:....4....:....5....:: 5 :
: ****** ******* : 6 :
: * ** * ** * : 7 :
: ** ** : 8 :
: ** **** : 9 :
: ** ** :10 :
: ** *** :11 :
: **** *** :12 :
:.mouse buttons (remove) :13 :
: :14 :
:TRUE or FALSE :15 :
:None :16 :
+-------------------------------------------------------+---+
Figure 6.3 True-False Template, edited, with line number
Note: Ruler line is 75 characters wide.
6.8.1 Header Lines
The first five lines, the header lines were
previously detailed, and are summarized in Quick Reference.
CAITeach MANUAL, Specific Templates, Chapter 6 -------------- Page 24
6.8.2 Text Lines
The question is written on the text lines, lines 6
through 12. You may start on any line. Lines left blank are
displayed blank.
6.8.3 Mouse Hot Spots
Line 13 is the mouse line. Erase everything on this
line or edit the master template file. The program draws the
buttons [TRUE] and [FALSE], formatted for this line. Their
position, label, and are color are fixed.
6.8.4 Graphic Figure
The text-graphic is optional. Delete, or substitute.
6.8.5 Answer Line
Line 15 is the answer line and it contains a TRUE,
or a FALSE, case immaterial.
6.8.6 The Answer Note Line
Line 16 contains "None" (no quotes) or a note. The
word "None" suppresses display of the line, but any other comment
is displayed after the word "Note:", exactly as enclosed in
brackets: [Note: ]. It is used to display a comment after the
student, correctly or incorrectly, answers the question.
6.9 The Multiple Choice Template (Qcode MC4)
The next figure shows an edited Multiple Choice Template.
Multiple Choice Template (MC4)
+-------------------------------------------------------+---+
:1 = Q 1 = 17 : 1 :
:; : 2 :
:MC4 : 3 :
:Citation: Template for Multiple Choice, Coded MC4 : 4 :
:Rule:r.a.1....:....2....:....3....:....4....:..c.5....:: 5 :
: : 6 :
: : 7 :
: : 8 :
: : 9 :
: :10 :
: . A choice.................... . C choi:11 :
: :12 :
: . B choice.................... . D choi:13 :
: :14 :
:ABCD (case immaterial) :15 :
:None. If none, leave None on this line :16 :
+-------------------------------------------------------+---+
CAITeach MANUAL, Specific Templates, Chapter 6 -------------- Page 25
6.9.1 Header Lines
The first five lines, the header lines were previously
detailed, and are summarized in Quick Reference.
6.9.2 Text Lines
The question is written on the text lines, lines 6
through 10. You may start on any line. Lines left blank are
displayed blank.
6.9.3 Mouse Hot Spots
As suggested by the template, the mouse hot spot are
drawn on lines 11 and 13, one space to the left of the period which
identifies the choices. The program automatically draws the button
labels, [ a ], [ b ], [ c ] and [ d ] formatted for these lines.
Their position, label, and are color are fixed. The letter "a" and
"c" on the ruler denote the starting position of those choices.
6.9.4 Answers Items
Answers Item are written on lines 11 and 13 as
outlined by the periods. The answer is limited to 30 characters in
the left column, and 28 in the right, again, as outlined by the
periods that are merged with the template.
6.9.5 Correct Answer
The correct answer must be either an "A", "B", "C",
or "D" although case is immaterial.
6.9.6 The Answer Note Line
Line 16 contains "None" (no quotes) or a note. The word
"None" suppresses display of the line, but any other comment is
displayed after the word "Note:", exactly as enclosed in brackets:
[Note: ]. It is used to display a comment after the student,
correctly or incorrectly, answers the question.
CAITeach MANUAL, Specific Templates, Chapter 6 -------------- Page 26
Chapter 7 RUNNING CAITeach
This chapter describes the procedure for running the CAITest file
from TutorialWriter and from the system prompt.
7.1 Preparation for Running from TutorialWriter
It is necessary, as part of writing the tutorial in TW, to
prepare the student with a screen. You must also advise the
student that once he or she starts the test it is impossible to
exit the program. The computer returns to TW after the test ends
so your next screen in TW should anticipate that. The message
depends on your style.
7.2 Other Considerations
Since the CAITest runs without TW one could write the
tutorial in TW, and then at a selected time administer the test
using only CAITeach. There are many variations.
CAITeach MANUAL, Running CAITeach, Chapter 7 ---------------- Page 27
7.3 Running CAITeach Test from TutorialWriter
The CAITeach test is called from TW with the #U command, and
four parameters. Example: #U {TEACHTW.EXE TEST.CHP Title
7.3.1 The Pound U, or #U Command.
Prescribed by TutorialWriter.
7.3.2 The Driver, {TEACHTW.EXE
The CAITeach driver which processes the CAITest file.
7.3.3 The Test File
The test file, included in the parameter list as
TEST.CHP is your file of questions and study screens.
7.3.4 The Title
Title references the title which appears at the top
of each CAI Test screen. It has a maximum of 5 words, but can not
be longer than 40 characters. The length is a function of TW, the
number of words is a function of CAITeach. Note that commas are
not used in this command.
7.3 Running CAITeach Test from DOS
CAITeach is called at DOS with the same parameters, except
there is no #U command. The title is limited to 5 words, but those
five words may be up to 70 characters.
CAITeach MANUAL, Running CAITeach, Chapter 7 ---------------- Page 28
7.4 The Printout
CAITeach prompts the student for a printed data sheet. To
obtain a copy of that data sheet enter {TEACHTW {T-STUDY.CHP and
answer the questions which follow immediately after the first
display.
CHAPTER 8 Quick Reference
8.1 A version of Quick Reference follows.
You may wish to access this from a window.
8.2 Template and File Types
CAITeach recognizes three questions, and one study template.
The template for each type is in a separate text file:
Study (information screen) ....... {T-STUDY.CHP
True-False Question............... {T-TF.CHP
Fill-In (Completion) Question..... {T-KB.CHP
Multiple Choice Question.......... {T-MC4.CHP
Subtypes (e.g., modified matching, answer bank) may be created.
8.3 Testing at DOS and from TW
CAITests are prepared by merging templates into an
master, composing the question, checking line sequence, DOS testing.
Syntax for DOS Test......... {TEACHTW FILE.EXT Title
Syntax for TW Test.......... #UTEACHTW.EXE FILE.EXE Title
8.4 Characteristics of ALL Templates
All templates have 16 lines. The first line requires a number
that denotes the line number of that question, and, optionally the
question number and starting line number of the next question.
That number is used by utilities such as {RENUM. See Note 6. That
number is typed into the file, or written with the utility, {RENUM.
8.5 Conceptual Divisions of CAITeach Templates
Templates, and their related questions are classed:
1. The header .................................. first 5 lines
2. The text and mouse lines, if any ............. next 9 lines
3. The answer and answer note, if any ...,,,..... next 2 lines
Each is detailed next, and illustrated in the generic
template.
HEADER: The header is always composed of five lines: the
number, comment, code, citation line, and the ruler line.
CAITeach MANUAL, Quick Reference, Chapter 8 ----------------- Page 29
TEXT OR QUESTION: The text or question part, including mouse
lines is always composed of nine lines. Mouse lines, if any,
vary with template. The program draws the mouse buttons. The
question is written on the text lines.
CAITeach MANUAL, Quick Reference, Chapter 8 ----------------- Page 30
ANSWER: The answer part is composed of two lines: the answer
line which always displays, and an answer note line, which may
or may not display. In the Study template the two answer
lines are a semicolon as there is no answer.
8.6 Generic Template Summary
See next two column display. Numbers in the next two columns
on the left reference each line; those lines with an asterisk
display, even if blank. Mouse buttons, and choices (A, B, C, or D)
for multiple choice, and [TRUE]/[FALSE] are drawn by CAITeach.
- Line - - Remark on Line -
.-----------------------------------------------------------------.
: 1 00001 = Q1 = 17 Required line number. See Note 6 :
: 2 ; Required (;), other for notes :
: 3 [QCode] Must have either STUDY, TF, KB, MC4 :
: 4*Citation Line Citation, Teaching Point, etc. :
: 5 Rule:r...:.. Format guide, 75 wide, See Note 7. :
: 6* Question/Text .-----------------------------.:
: 7* Question/Text :See below for template types ::
: 8* Question/Text :Line 1 each template must ::
: 9* Question/Text : have a number other than 0 ::
:10* Question/Text : {RENUM will renumber ::
:11* Question/Text :Line 3 must have either: ::
:12* Question/Text : STUDY, TF, MC4, or KB ::
:13* Question/Text :-----------------------------::
:14* Question/Text :
:15 Answer Line Displays after student answer. See Notes: 1,2:
:16 Answer Note See Note 5. :
+-----------------------------------------------------------------+
----
1. STUDY Type: Lines 15 and 16 start with semicolon.
2. FILL-IN: Answer is entered on line 15, any case, up to
50 characters. Can not include tilde or percent sign.
3. TRUE-FALSE: Enter question in text lines before line 13.
Mouse buttons are drawn on 13 by program. Line 14 remains
blank.
4. MULTIPLE CHOICE: Enter question in text lines before line
11. Mouse "buttons" drawn by program on lines 11 and 13.
Choices A and C, left column; B and D, right column.
Lines 12 and 14 remain blank.
5. To suppress display enter word "None," no quotes, no comma.
6. The first five spaces on the first line of each template
must contain a number other than 0. For convenience, also
include the question number, and the beginning line number
of the next question, but program utilities use only the
first five spaces. Type the number, or use the renumbering
utility. {NUMAID.DOC as an aid.
CAITeach MANUAL, Quick Reference, Chapter 8 ----------------- Page 31
7. Margin and formatting guide, 75 characters wide. Program
reads only first five spaces and expects to find "Rule:" ---
remainder of line may be erased, used for comment.
8.7 Summary of Steps to Prepare CAITest
A. Prepare tutorial in TutorialWriter
B. Import/merge question types into editor
C. Compose question
D. (Optional) Recommended: Manually renumber file, or
check and renumber with {RENUM. {RENUM must find a
number on line 1
E. Check file at DOS. Command is: {TEACHTW FILE.EXT Title
F. Call file from TutorialWriter: #U FILE.EXT Title
CAITeach MANUAL, Quick Reference, Chapter 8 ----------------- Page 32
CHAPTER 9 Renumbering Aid
+------------------+ +------------------+
: 1 = 1 = 17 : : 657 = 41 = 673 :
: 17 = 2 = 33 : : 673 = 42 = 689 :
: 33 = 3 = 49 : : 689 = 43 = 705 :
: 49 = 4 = 65 : : 705 = 44 = 721 :
: 65 = 5 = 81 : : 721 = 45 = 737 :
:..................: :..................:
: 81 = 6 = 97 : : 737 = 46 = 753 :
: 97 = 7 = 113 : : 753 = 47 = 769 :
: 113 = 8 = 129 : : 769 = 48 = 785 :
: 129 = 9 = 145 : : 785 = 49 = 802 :
: 145 = 10 = 161 : : 801 = 50 = 817 :
:..................: :..................:
: 161 = 11 = 177 : : 817 = 51 = 833 :
: 177 = 12 = 193 : : 833 = 52 = 849 :
: 193 = 13 = 209 : : 849 = 53 = 865 :
: 209 = 14 = 225 : : 865 = 54 = 881 :
: 225 = 15 = 241 : : 881 = 55 = 897 :
:..................: :..................:
: 241 = 16 = 257 : : 897 = 56 = 913 :
: 257 = 17 = 273 : : 913 = 57 = 929 :
: 273 = 18 = 289 : : 929 = 58 = 945 :
: 289 = 19 = 305 : : 945 = 59 = 961 :
: 305 = 20 = 321 : : 961 = 60 = 977 :
:..................: :..................:
: 321 = 21 = 337 : : 977 = 61 = 993 :
: 337 = 22 = 343 : : 993 = 62 = 1009 :
: 353 = 23 = 369 : :1009 = 63 = 1025 :
: 385 = 24 = 401 : :1025 = 64 = 1041 :
: 401 = 25 = 417 : :1041 = 65 = 1057 :
:..................: :..................:
: 417 = 26 = 433 : :1057 = 66 = 1073 :
: 433 = 27 = 449 : :1073 = 67 = 1089 :
: 449 = 28 = 465 : :1089 = 68 = 1105 :
: 465 = 29 = 381 : :1105 = 69 = 1121 :
: 481 = 30 = 497 : :1121 = 70 = 1137 :
:..................: :..................:
: 497 = 31 = 513 : :1137 = 71 = 1153 :
: 513 = 32 = 529 : :1153 = 72 = 1169 :
: 529 = 33 = 545 : :1169 = 73 = 1185 :
: 545 = 34 = 561 : :1185 = 74 = 1201 :
: 561 = 35 = 577 : :1201 = 75 = 1217 :
:..................: :..................:
: 577 = 36 = 593 : :1217 = 76 = 1233 :
: 593 = 37 = 609 : :1233 = 77 = 1249 :
: 609 = 38 = 625 : :1249 = 78 = 1265 :
: 625 = 39 = 641 : :1265 = 79 = 1281 :
: 641 = 40 = 657 : :1281 = 80 = 1297 :
+------------------+ +------------------+
CAITeach MANUAL, Renumbering Aid, Chapter 9 ----------------- Page 33
CHAPTER 10 Operational Definitions
Words of interest to CAITest documentation, operationally defined.
------
authoring files Minimum files required to construct and
display CAITest. Includes {TEACHTW and
four template files: {T-*.CHP
blank line A blank line in a question or text
display consists only of an invisible
carriage return: just leave it blank. To
leave the Answer Comment line blank start
it with "None" - no quotes.
CAI Computer Aided Training
CAIT Computer Aided Training Teach,
abbreviation for CAITeach.
CAITest One or more templates merged and formatted
for CAITeach
CAIUtilities Series of utilities which help format
CAITest file. Basic CAITeach includes
Remnumbering. CAITeach - Pro includes
Line, Insert, Cut, and Build. Line, insert,
and cut are available separately.
case immaterial Referenced item, often a word of file
name may be in upper or lower case.
CBT Computer Based Training
CHP Accept extension for CAITest files. This
extension is recognized by the TW editor.
control KR A keystroke executed by depressing the
control key while also pressing the K
and R key. [TW editor merging command]
directory (make) Organizes a group of files on a disk. It
is the DOS command MD followed by the
directory name. Consult DOS reference.
driver (file) The CAITeach driver file is {TEACHTW.
filler text line blank line in CAITeach template used to
complete set of 16 lines required for
each template. Usually starts with a
semicolon
CAITeach MANUAL, Operational Definitions, Chapter 10 -------- Page 34
filler line Same as filler text line.
grave character Character, "`" available on all keyboards.
invisible lines Term used to describe lines created at
the end of editors. The lines are
created by pressing [ENTER] or deleting
other lines, but are invisible since
there is no end-of-file marker.
CAITeach reads these lines and displays
an error, calculating them to be entered
as a part of the template format. Problem
is solve with <EOF> marker that exist in
many editors.
key stroke Usually two typed strokes. Often
references holding down one key, and
pressing others, as in the key stroke
[Control K R].
Line When used as a proper noun references a
line or lines within a CAITemplate.
Usually followed by an number, the
referenced line number.
merge To combine two similar files into a
single file. Usually done with an
editor.
Number Aid (NumAid) References the file, or the printout of
the file which shows line 1 of the first
40 questions formatted in a CAITeach
Test.
percent (CAIT) The percent sign can not be use as the
answer in a fill-in questions. To
display preface it with a tilde. See
Chapter 5.
Question Code CAITeach reads Line 4 of the template
and processes template lines based
on the Question or QCode. There are
several codes, depending on the version.
The basic version has the codes: STUDY,
TF, MC4, and KB. May be entered in
upper or lower case (or combination).
QCode See Question Code
Quick Reference A file, {QIKREF.DOC, or its two page
printout, which summarizes instructions
for composing CAITeach files.
CAITeach MANUAL, Operational Definitions, Chapter 10 -------- Page 35
screen margin The left screen margin is set at 3 by
CAITeach. The right margin is set by the
ruler guide.
system (level) Same as DOS prompt, or "at DOS"
template (CAI) References either the four template
files, or the particular sequence of 16
lines used in a CAITest file to format a
CAI question or study (text) screen.
test file (CAI) See CAITest
text editor A program that assist with the
preparation of narrative data. In TW it
is accessed from the "Create/Edit
Chapter" option.
tildes (CAIT) The tilde can not be use as part of the
answer in a fill-in questions. To
display it preface it with three other
tildes, but the CAIUtilities, such as
Renumber will not process it. See
Chapter 5.
TW Abbreviates TutorialWriter
utilities (CAI) See CAIUtilities
CAITeach MANUAL, Operational Definitions, Chapter 10 -------- Page 36
